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PREFACE 


This  volume  is  one  of  a series  which  documents  a Search  and 
Rescue  Simulation  Model  for  the  United  States  Coast  Guard.  The 
material  reported  in  this  documentation  was  developed  by  an  inter- 
disciplinary team  at  the  National  Bureau  of  Standards  with  representa- 
tion from  the  U.S.  Coast  Guard  under  MIPR  Z-70099-0-01935. 

The  complete  documentation  is  comprised  of  the  following: 

Volume  I Executive  Level  Documentation 

Volume  II  Analyst  Level  Documentation 

Volume  III  Programmer  Level  Documentation  for  "PREPROCESSOR" 

Volume  IV  Programmer  Level  Documentation  for  "OPSIM" 

Volume  V Programmer  Level  Documentation  for  "POSTPROCESSOR" 

Appendix  A Flow  Charts  for  Programmer  Level  Documentation 
Appendix  B Program  Listings  for  Programmer  Level  Documentation 
The  study  was  initially  conducted  under  the  supervision  of  Martin 
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POSTPRO  Programmer ' s Documentation 


I . Introduction 

In  order  to  examine  the  voluminous  amount  of  data  generated  by  a 
complex  simulation  such  as  SARSIM,  an  efficient  post-processor  is  a 
definite  requirement. 

The  reader  is  reminded  that  the  Standard  Output  display  (from 
OPSIM)  is  given  for  each  run  of  OPSIM.  The  OPSIM  Section  explains 
this  output  and  the  calculations.  The  processing  of  data  other  than 
that  presented  in  the  Standard  Output  is  an  option  to  the  SARSIM 
user.  To  explain  further,  it  is  recalled  that  the  Standard  Output 
consists  mostly  of  summary  statistics  on  resource  and  station 
utilizations  derived  and  output  in  several  ways.  In  contrast,  the 
output  relative  to  each  case  after  being  simulated  in  the  system, 
can  be  filed,  so  that  the  simulation  user  can  examine  any  aggregate 
of  case  attributes  or  simply  the  case  attributes  themselves.  A 
means  had  to  be  devised  such  that  the  user  can  access  the  data 
fairly  simply  and  extract  it  in  summary  form  as  he  wishes. 

A generalized  information  retrieval  system  with  the  additional 
capability  to  supply  a variety  of  options  such  that  the  user  can 
tailor  the  output  to  his  requirements  can  be  found  in  Quick  Query.1, 

1/  Developed  for  the  Economic  Development  Administration  by 
Consolidated  Analysis  Centers  Inc. 
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Basically,  Quick  Query  offers  the  user  the  ability  to  supply 
the  criteria  for  selection  of  specific  data  on  file;  the  formulae 
for  any  calculations  he  wishes;  and  the  sequence  in  which  he  wishes 
the  output  to  be  produced. 

Quick  Query  is  used  in  conjunction  with  software  necessary 
to  define  the  case  attributes  and  set-up  the  file.  The  File 
Definition  § Maintenance  (FDM)  software  does  the  file  set-up  and  is 
applied  to  the  output  once.  Quick  Query  is  applied  to  this  new  file 
as  often  as  the  user  desires.  It  is  noted  that  the  user  may  wish  to 
batch  several  requests  when  using  Quick  Query,  and  can  therefore 
obtain  any  number  of  special  processing  requests  at  any  one  time. 

The  next  part  describes  the  application  of  Quick  Query 
and  File  Definition  5 Maintenance  to  SARSIM  and  how  Quick  Query 
can  be  used  to  fulfill  the  user's  needs. 
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II.  Userfs  Guide  and  Description 


A.  FDM 

This  section  describes  the  File  Definition  and  Maintenance  (FDM) 
Program  which  was  developed  by  Consolidated  Analysis  Centers,  Incor- 
porated, for  the  Economic  Development  Administration  (EDA) . 

The  purpose  of  FDM  is  to  define  new  Quick  Query  Program  (OOP)  files 
or  to  modify  existing  QQP  files.  FDM  works  in  conjunction  with  QQP:  FDM 
is  a system  which  actively  constructs  or  modifies  the  file  structure  which 
QQP  passively  accesses  for  data  retrieval,  manipulation,  and  display. 

Since  QQP  is  described  in  detail  elsewhere,  this  section  will  concern 
itself  solely  with  FDM.  The  standard  reference  manual— ^ for  FDM  provides 
more  complete  and  detailed  information  and  should  be  consulted  before 
significant  changes  are  made  to  the  existing  FDM  program.  This  section 
will  discuss  only  FDM  as  implemented  for  SARSIM  in  order  to  provide  the 
user  easy  access  to  the  relevant  information. 

The  FDM  program  employs  six  types  of  control  cards  labeled  A through 
F and  a FORTRAN  subroutine  called  USERRD.  The  FORTRAN  routine  will  be 
discussed  later.  We  concern  ourselves  now  with  the  six  types  of  control 
cards  and  how  they  were  used  in  SARSIM.  To  facilitate  understanding  the 
following  explanation,  the  reader  is  urged  to  consult  the  standard  FDM 
form,  Figure  1,  and  FDM  computer  printout,  Figure  6.  Both  are  contained 
on  the  next  few  pages.  Lastly,  if  more  than  one  card  of  a given  type  was 
used  in  FDM,  e.g.,  the  B card,  then  only  the  first  card  of  the  given  type 
is  explained. 

— FILE  DEFINITION  AND  MAINTENANCE  USERS  MANUAL,  Bergfried,  U.S. , and 

Slack,  G.  G.,  Consolidated  Analysis  Centers Incorporated , December  1969. 
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Card 

I Y21 


A 


B 


FDM  Control  Cards 


Columns 

Entry 

Explanation 

1 

A 

Card  Type  Identification 

3-14 

Cummings  LK 

Requestor  Identification 

16-23 

12-15-70 

Request  Date 

26 

Blank  since  the  Custodian  program  which  is 
contained  in  the  EDA’s  Comprehensive  Infor- 
mation System  and  Data  Base  is  not  used. 

33 

X 

Used  for  defining  an  entirely  new  QQP  file, 
rather  than  modifying  an  existing  file. 

37-38 

29 

This  blocking  factor  was  used  to  minimize 
processing  time. 

41 

Blank  since  this  run  defined  rather  than 
modified  a QQP  file. 

44 

? f 

46 

t f 

56 

X 

Must  be  checked  for  file  definition. 

61-72 

Case 

Left  justified.  This  is  the  name  of  the 
entity  to  which  the  attributes  named  on  the 
B- cards  belong. 

1 

B 

Card  Type  Identification 

3-5 

CRE 

This  name  tells  the  FDM  program  that  we 
wish  to  create  an  attribute. 

7-18 

SEQNO 

Name  of  the  attribute  created 

19 

I 

The  attribute  is  integer  data 

20-21 

5 

Field  width  of  attribute.  Includes  two  extra 
digits  since  attribute  will  be  sub totaled. 

23 

X 

Indicates  a sum  should  not  be  computed  for 
this  attribute  when  subtotaling  is  requested. 

27-28 

1 

Number  of  words  occupied  by  this  attribute 
when  returned  by  USERRD  subroutine.  Integer 
fields  require  only  1 word.  Right  adjusted. 

29-33 

1 

Tells  FDM  program  where  the  attribute  is 
located  in  the  array  IA  passed  from  USERRD. 
Right  justified. 

34-35 

6 

Size  of  the  heading  field.  This  number  must 
be  at  least  as  large  as  the  longest  word 
in  the  following  three  fields. 

36-47 

First  line  of  heading.  Free  form. 

48-59 

SEQ 

Second  line  of  heading.  Free  form. 

60-71 

NO 

Third  line  of  heading.  Free  form. 
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Card 

IZEi 

C 


Columns 


Entry 


Explanation 


1 C 

3-14  SEQNO 

15  L 


Card  Type  Identification 

This  sequencing  attribute  determines  the  order 
of  the  entity  cases. 

The  sequencing  attribute  is  collated  low  to  high. 


DID 

3-14  OPFAC 
17-28  NOCAS 
31-42  IDLOC 
45-56  OCCUR 
59-70  BOX 


Card  Type  Identification 

The  name  of  the  attribute  to  be  displayed. 

The  name  of  the  attribute  to  be  displayed. 


Tl 


E 


1 E 

3-5  CRE 

10-12  FOR 

16-27  NOMASTER 


Card  Type  Identification 

Tells  FDM  that  the  update  operation  is  to 
add  a new  entity  record  to  the  output  file. 
Since  the  attribute  values  of  the  new  records 
are  exactly  the  same  as  the  values  on  the 
transaction  file,  CRE  is  the  only  explicit 
operation  specified. 

A linking  phrase.  The  file  was  created 
exactly  as  it  came  from  the  USERRD  routine. 
Therefore  we  have  specified  no  criterion 

The  only  keyword  recognized  for  CRE. 


F 


None  used  since  it  was  not  necessary  to  define 
intermediate  attributes . 


FORTRAN  subroutine  USERRD  is  used  by  FDM  to  read  the  values  of  attributes 

from  data  cards.  These  values  are  used  by  FDM  to  update  or  create  a file 

record.  Figure  2 is  a hard  copy  of  the  USERRD.  Figure  3^-  is  the  flow 

2/ 

chart  for  USERRD  and  Figure  4—  is  an  example  of  the  function  of  the  read 
— ^ Ibid. , p.  83. 

— Ibid.  p.  82 
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routine.  Figure  sL/  gives  the  deck  sequence  necessary  for  an  FDM  run.  For 
a complete  explanation  of  USERRD,  the  user  should  study  pp.  70-84  of  the 
FDM  manual.  A brief  discussion  of  the  routine  follows: 

NCOND  and  NSTAT  are  flags  for  passing  information  between  FDM  and  USERRD. 
NCOND  is  set  by  FDM  and  indicates:  1 to  open  file;  2 for  moving  a record, 
or  3 to  close  file.  Initially  NCOND  is  set  to  one.  NSTAT  is  set  by  USERRD 

as  follows:  1 for  normal  return,  -2  for  end  of  file,  or  -3  for  read  error. 

IA  is  the  data  and  position  array,  and  LEN  is  the  length  of  the  IA  array. 

NSTAT  is  set  to  one  initially  by  USERRD.  NOENT  counts  the  number  of  entities 
processed,  and  is  used  only  in  card  39  of  USERRD. 

The  function  of  each  statement  of  USERRD  should  be  clear  to  users 
having  a working  knowledge  of  FORTRAN.  Thus  only  a few  sections  of  the 
code  will  be  discussed.  Cards  9-12  pass  the  IA  array  to  FDM  informing  FDM 
how  many  words  of  the  IA  array  each  variable  will  occupy  when  filled  by 
the  read  statements.  The  numbers  filling  IA  should  correspond  to  reading 
down  column  27  of  the  B-cards.  Cards  16-27  fill  the  IA  array  with  the  attri- 
butes of  a particular  entity.  Cards  31-33  close  the  file  after  all  the 
entities  are  processed.  Cards  34-41  are  used  to  print  one  of  two  types  of 
messages  indicating  normal  or  abnormal  termination:  of  processing. 

As  stated  above,  if  the  number  of  attributes  is  to  be  changed  for  the 
entity  CASE,  certain  changes  must  be  made  to  USERRD.  First,  the 
DIMENSION  statement  should  reflect  the  number  of  attributes  of  the  entity. 
Second,  LEN  should  equal  the  number  to  which  IA  is  dimensioned.  Third,  the 
read  statements  and  their  associated  FORMAT  statements  should  be  changed  to 
read  the  proper  number  of  attributes. 

1/  Ibid.  p.  70 
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If  the  field  size  of  an  attribute  is  changed,  the  FORMAT  statement 
associated  with  reading  the  attribute  should  reflect  that  change. 

Also  Columns  20-21  of  the  B card  for  that  attribute  should  be  changed. 
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Figure  2 
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B.  Quick  Query 

The  Quick  Query  Program  (QQP)  is  used  in  SARSIM  to  access  and 
display  case  data  which  is  input  to  or  output  from  a simulation  run. 

The  first  use  of  QQP  in  SARSIM  is  to  display  all  attributes  of  each 
case  and  to  derive  cross  cases  statistics  for  each  of  these  attributes. 
The  second  use  is  to  compute  cross  case  statistics  where  the  only 
cases  considered  satisfy  particular  attribute  selection  criteria. 

These  two  uses  will  be  described  separately  and  more  completely  below. 

The  QQP  manual—  contains  more  complete  and  detailed  information 
than  the  following  explanation  and  should  be  consulted  before  any 
major  changes  are  made  to  the  QQP.  Since  QQP  passively  accesses  an 
existing  file  structure,  all  information  used  in  building  a QQP  pro- 
gram should  be  compatible  with  the  information  used  by  FDM  to  build 
that  file. 

A QQP  program  may  contain  eleven  types  of  control  cards  labeled  A 
through  K and  a special  report  generator  section.  The  special  report 
generator  option  was  not  used  in  SARSIM,  as  the  standard  QQP  output 
format  satisfied  the  project’s  needs. 

1.  General  application  of  QQP.  This  section  describes  the  use  of 
QQP  for  displaying  and  computing  cross  case  statistics  for  attributes  of 
all  cases  in  a simulation  run.  Because  the  total  field  width  of  all 
attributes  is  so  large,  it  was  necessary  to  write  five  batch  processed 
QQ  programs  to  properly  display  the  attributes  by  computer  printout. 
Copies  of  programs  one  through  five  are  shown  in  Figures  7 through  11 

T / 

— Consolidated  Analysis  Centers  Inc., "Quick  Query  User's  Manual  for 
Economic  Development  Administration".  January  1970 
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respectively.  Part  of  the  summary  statistics  for  program  one  is 
displayed  in  Figure  12.  An  example  of  part  of  the  output  of  programs 
one  through  five  is  shown  in  Figures  13  through  17.  Figures  18  and  19 
are  standard  QQP  forms . With  reference  to  Figures  7 , 18 , 19 , the 
reader  can  comprehend  the  following  chart  easily.  This  chart  contains 
an  explanation  only  for  program  one;  the  others  are  very  similar. 

Only  the  first  D-card  in  each  program  will  be  explained  as  the  other  D- 
cards  are  filled  in  exactly  the  same  manner. 


CARD  TYPE  COLUMN  ENTRY  EXPLANATION 


A 

1 

A 

Card  Type  Identification 

3-14 

Cummings  LK 

User  Identification 

17-28 

TAD 

Organization  of  User 

31-54 

i Demand  Tape 
Analysis 

Report  Identification 

59-70 

CASE 

File  Name  as  defined  in  FDM 

B 

1 

B 

Card  Type  Identification 

35 

S 

Requested  for  Summary  Statistics 
(Mean,  Standard  Deviation,  Sum, 
Minimum,  Maximum)  of  each  attribu' 
defined  on  a D-card. 

C 

1 

C 

Card  Type  Identification 

3-67 

i Demand  Tape 

Free  form  heading  that  will  appea1 

1 

Analysis 

) 

above  QQP  output. 

D 

1 

D 

Card  Type  Identification 

4-15 

| 

i 

I 

i 

SEQNO 

i 

i 

j 

! -15- 

! 

An  attribute  of  CASE  to  be  dis- 
played. This  is  also  the  attri- 
bute we  use  for  sequencing  the 
cases. 

i 


CARD  TYPE  COLUMN  ENTRY  EXPLANATION 


1 

E 

' 

Card  Type  Identification 

. 

4-15 

SEQNO 

The  attribute  of  CASE  that  we 

use  for  sequencing. 

16 

L 

Informs  QQP  the  user  wishes  Low 

i 

to-High  sequencing. 

Figure  20  shows  the  deck  sequence  necessary  to  run  the  batch  processed 
program  just  mentioned. 

2.  Special  Requests  Using  QQP.  This  section  describes  the  use  of 
QQP  for  computing  cross  case  statistics  where  the  only  cases  included 
in  the  computation  are  those  that  possess  attributes  satisfying  certain 
selection  criteria.  Because  each  request  has  its  own  unique  set  of 
selection  criteria,  a separate  program  must  be  written  for  each  query. 
Special  request  programs  one  through  eight  appear  in  Figures  21 
through  28  respectively.  Since  cards  A,  B and  E are  exactly  the  same 
for  programs  one  through  eight,  they  will  only  be  discussed  for  program 
one.  Card  type  C will  be  discussed  for  program  one  since  it  is  of  free 
form  and  is  used  only  for  a header.  Card  D merely  labels  the  attribute 
computed  by  the  G cards  for  display  and  only  need  be  discussed  for  the 
first  program.  The  F and  G cards  differ  for  each  of  the  eight  special 
request  programs  and  will  be  explained  separately.  For  clarity  and 
completeness , the  discussion  of  these  two  card  types  will  be  different 
from  the  way  card  types  A through  E were  described. 


CARD  TYPE 

COLUMN 

ENTRY 

EXPLANATION 

A 

1 

A 

Card  Type  Identification 

3-14 

Elliott  WH 

User  Identification 

-16- 

CARD  TYPE 


COLUMN 


ENTRY 


EXPLANATION 


17-28 

31-54 

59-70 

1 

33 


TAD 

Selected 

Case 

Analysis 

CASE 

B 

D 


Organization  of  user. 

Report  Identification 

File  name  as  defined  in  FDM. 

Card  Type  Identification 

Request  to  display  all  attributes 
listed  on  D cards. 


C 


I 

I 


1 


C 


Card  type  Identification 


3-67 


Cross  Case 
Analysis . . 


Free  form  heading  that  will  appear 
above  QQP  output. 


D 


1 


D 


Card  Type  Identification 


4-15  PCTONE 


\ 


A temporary  attribute  to  be 
displayed.  The  value  of  this 
attribute  is  computed  by  the  G- 
cards . 


1 

4-15 


E 

Box 


16 

17 


L 

P 


18 


Card  Type  Identification 

The  name  of  the  part  sequencing 
attribute.  Since  it  has  a value 
of  zero  for  all  cases,  we  will 
get  subtotal ing  only  after  all 
cases  have  been  processed.  This 
is  a key  to  the  method  employed 
to  get  the  percentage  of  cases  that 
fit  certain  criterion. 

Sequence  is  Low- to -High 

Skip  to  top  of  next  page  after  each 
sub total ing  activity. 

Provide  subtotals  for  all  attributes 
on  D cards  when  the  sort  sequence 
number  changes  value. 
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The  purpose  of  program  one,  Figure  21,  is  to  compute  the  percent 
of  cases  with  the  initial  priority,  FPRI , greater  than  or  equal  to 
three  where  the  case  was  not  served  within  tolerance.  Symbolically, 
we  state  the  conditions  as:  (ITOL  = 0)  A (FPRI  > 3).  This  is  exactly 

what  is  coded  on  the  two  F cards.  The  simulation  run  for  which  these 
special  requests  were  made  had  881  cases.  The  reciprocal  of  this  number 
is  approximately  0.001135.  Thus,  to  compute  the  desired  percentage 
all  that  need  be  done  is  to  find  the  number  of  cases  satisfying 
the  given  requirements  and  multiply  this  number  by  0.1135. 

Let  Z equal  the  number  of  cases  that  satisfy  the  selection  criterion. 
The  following  equations  yield  the  desired  percentage: 

% = (Z/881)  x 100  = Z x (0.001135)  x 100  = Z x (0.1135) 

By  placing  PCTONE  = 0.1135  on  the  G card  and  requesting  a subtotal 
for  only  this  temporary  attribute  and  by  subtotaling  across  only  those 
cases  that  satisfy  the  selection  criteria,  we  compute  the  desired 
statistic. 

The  purpose  0f  program  two,  Figure  22,  is  to  compute  the  percentage 
of  cases  with  the  first  priority  equal  to  one  is  where  the  case  was  not 
served  within  tolerance.  Symbolically  this  is  stated  as: 

(FPRI  = 1)  A (ITOL  = 0)  . 

These  selection  conditions  are  found  on  the  two  F cards.  The  re- 
mainder of  the  program  is  exactly  the  same  as  program  one  with  the  ex- 
ception that  PCTTWO  is  substituted  for  PCTONE. 

The  purpose  of  program  three,  Figure  23,  is  to  compute  the 
average  time  to  vector  to  a case.  To  do  this  (TWAIT-TQUE1)/881  is  com- 
puted for  each  case,  and  then  a subtotal  is  requested  of  this  temporary 
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attribute.  Since  no  F cards  appear  in  this  program,  by  default  all 
cases  are  considered  to  have  passed  the  selection  criterion. 

Program  four,  Figure  24,  was  designed  to  compute  the  average 
time  a case  must  wait  between  its  arrival  into  the  system  and  the 
time  when  the  first  resource  reaches  the  case.  By  computing 
(TWAIT/881)  for  each  case  and  then  summing  these  temporary  attributes, 
the  required  percentage  is  derived.  In  this  program  no  F cards 
are  used  so  all  cases  are  included  in  the  calculation. 

Program  five.  Figure  25,  computes  the  percentage  of  cases  with 
the  number  of  tows,MMM,  greater  than  zero.  The  selection  criterion 
is  on  the  F card  and  the  temporary  attribute,  MGRZ,  used  for  sub- 
totaling,  is  on  the  G card.  The  reason  MGRZ  equals  0.1135  has  been 
previously  explained. 

The  purpose  of  program  six,  Figure  26,  is  to  compute  the 
percentage  of  cases  with  the  number  of  tows  greater  than  zero  and  the 
number  of  non- tow  needs  equal  to  zero.  Symbolically  stated  the  selection 
criterion  is: 

(M4M  > 0)  A (NNN  = 0).  This  criterion  is  coded  on  the  F cards. 

The  G card  has  been  previously  explained. 

Program  seven,  Figure  27,  computes  a cross  case  statistic  under 
more  complicated  selection  criterion  than  before.  This  request  is 
for  the  percentage  of  long  search  cases,  completed  in  the  simulation. 
Symbolically  the  criterion  is  stated: 

[ (RESA6  > 0)  v (RESA7  > 0)  v (RESA8  > 0)  v (RESA9  > 0)  v (RESA10  > 01] 
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A [SIS  = -1]  A [TSM  > 0].  Since  a logical  OR  is  dominant  over  a 
logical  AND,  for  conciseness  it  is  necessary  to  define  a temporary 
attribute  called  TEMP.  If  at  least  one  of  the  RESA6  through  RESA10 
is  greater  than  zero,  TEMP  is  considered  to  be  TRUE  because  of  the 
way  it  is  defined  on  the  F cards.  Thus  the  selection  criterion  is 
reduced  to: 

(TEMP  = TRUE)  A (SIS  = -1)  A (TSM  > 0) . This  criterion  is  coded 
on  the  F cards.  The  G card  has  been  previously  explained. 

Program  eight.  Figure  28,  is  very  similar  to  program  seven 
and  can  be  used  to  find  the  percentage  of  cases  with  a short  search. 

In  this  program,  however  RESA(I)  must  equal  zero  for  all  1=6, 

7,  8,  9,  10.  Symbolically  written  the  criteria  is: 

(RESA6=0)  A (RESA7=0)  A (RESA8=0)  A (RESA9  = 0)  A (RESA10=0)  A (TSM>0) . 
These  conditions  are  coded  in  the  F cards.  The  G card  has  been 
previously  described. 

Figure  20  contains  the  deck  sequence  necessary  for  batch 
processing  this  group  of  special  requests. 
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FIGURE  13:  Partial  Output  of  Program 
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FIGURE  14:  Partial  Output  of  Program  1 
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FIGURE  15:  Partial  Output  of  Program  1 
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FIGURE  16:  Partial  Output  of  Program  1 
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FIGURE  17:  Partial  Output  of  Program 
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FIGURE  22:  Program  to  Compute  Percent  of  Cases  With 

Initial  Priority  Equal  to  1 and  Case  Not 
Served  Within  Tolerance. 
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FIGURE  24:  Program  to  Compute  Average  Wait  Time  Between 

Arrival  Into  System  and  Time  First  Resource 
Reaches  Case. 


LISTING  OF  QULRY  p.PUT  CARDS 


UJ 

3 

•< 

CL 


Ui 

£L 


<D 

a 


CD 

a 


ui 

CNJ 


3 


O 

rg 

ac 

UJ 

D 

X 

UJ 

•3 

UJ 

3 


Q 

UJ 

►— 

O 

UJ 


in 


Q 

<1 

►— 

X 


UJ 

3 

G 


o 

o 


>0 

lit 


QC 

3 

9 

X 

X 

X 

o 

z 


o 

-1 


o 


D* 

rsj 

QZ 

UJ 

LO 

£ 

UJ 

o 

UJ 

O 


Nl 

or  x 

o 

X CD 


a ui 


JNJ 

QC 

IS 

X 


/ 


QC 

UJ 

3 

(3 

*C 

U» 

3 

G 


O 

• 

QC 

19 

• 

X 

X 

X 

UJ 

z 

> 

r 

in 

UJ 

in 

13 


CL 


M 

or 

3 

X 


in 

CD 

9 

>0 


cd 

U 

Mh 

o 

<D 

bJ) 

cd 

+-> 

<X> 

U 

<u 

PU 


o 

CJ 


bC 
O 
fn 
PU 


l-H 

PU 


With  Number  o£  Tows  Greater  Than  Zero. 


LISTING  of*  q U t R Y I'PUT  CAROS 


a. 


3 


O' 


c 


LJ 

UJ 

_t 

UJ 

tr 


o 

■< 


X 


-I 

UJ 


q: 

UJ 

3 

3 

UJ 

3 

O 


uJ 

u3 

«st 

0. 


lH 

fVJ 


20  O 
fr- 
ee 

rv 

>o 

d"> 

X 

rn 

rv 

3 

> 

20 


J1 


fN4  UJ 

— <n 

O D « 

o UJ 

00 


•o 

X 

rn 

<NJ 


U"> 


3 

o- 


LH 


< 

2 


X 


« (B 


O 

3 


Q 

2 


3 

2 


o a 

o:  3 
<9  UJ 


in  x 2 

CL  X 2 

3 X Z 


o 

z 

c 


o 

& 


in 

rn 


n 


ro 

*— 

uj 

CL 

<3 


a 

fr 


O' 

(Ni 

ac 

UJ 

ti 

r 

.-sJ 

L» 

UJ 

Q 


UJ 

in 

< 

UJ 


o: 

UJ 

3 

O 

ic 

UJ 

3 

3 


O 

• 

or 

e? 


X 

X 

X 


> 

« 

X 


in 

UJ 

in 

< 

UJ 


z 

uJ 

UJ 

ar 

UJ 

CL 


ifi 

X 

»*o 


FIGURE  26:  Program  to  Compute  Percentage  of  Cases  With 

Number  of  Non-Tow  Needs  Equal  Zero. 
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FIGURE  27:  Program  to  Compute  Percentage  of  Long  Search  Cases 
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FIGURE  28:  Program  to  Compute  Percentage  of  Short  Search  Cases 


III.  Interpretation  of  QQ  Output  for  Displayed  Cases 


Some  of  the  case  parameters  output  by  QQ  need  explanation  because  they 
may  be  derived  or  updated  by  OPSIM.  Due  to  the  constraints  imposed 
by  limited  storage  and  the  FEM  requirement  of  a fixed  field  format 
for  all  cases,  not  all  the  information  on  a case  could  be  retained. 
Trade-offs  were  indeed  necessary  in  light  of  these  constraints,  and 
were  made  such  that  the  loss  of  information  would  be  both  minimal 
and  infrequent. 

Below  is  a list  of  the  output  parameters  retained  in  every  case , 
that  is  processed  in  the  system;  that  is,  every  completed  case.  (Recall 
that  exceptional  cases  are  displayed  automatically  as  Standard  Output 
from  OPSIM;  cases  being  processed,  but  not  completed  at  the  end  of  the 
simulation  are  also  output  as  part  of  the  Standard  Output.)  Exceptional 
cases  also  appear  on  the  output  tape  at  the  end  of  the  case  listing  and 
may  be  used  in  the  QQ  calculations  if  desired. 

The  reader’s  attention  is  called  to  the  OPSIM  Definition  discussion 
for  a listing  of  these  parameters  and  their  interpretation  in  OPSIM.  The 
discussion  presented  here  sketches  the  ranges  of  these  values  when  the 
case  is  completed  and  output  from  the  system. 

CASE  PARAMETER  VALUE  EXPLANATION 

C-130  case  which  occurred  in  the  district 
being  exercised.  This  assignment  is  made  in 
the  PREPRO.  Other  C-130  cases  are  assigned 
| to  E City  (East  Coast)  . 

I 

The  original  station  to  which  the  case  was 
assigned,  in  PREPRO.  (OPSIM  reassigns  the 
primary  station  to  the  case  and  retains 
this  new  assignment  in  STATN) . In  the  situa- 
tion of  multi-unit  cases,  PREPRO  assigned 
the  station  which  first  received  the  distress 
call  as  the  OPFAC.  (Minimum  value  of  Cl  on 
SAR  assistance  form.) 


(1)  OPFAC 


>0 


-43- 


CASE  PARAMETER 

VALUE 

EXPLANATION 

(2)  NOCAS 

(3)  IDLOC 

>0 

>0 

. 

The  original  case  identification  number; 
together  with  OPFAC,  these  values  repre- 
sent the  unique  historical  case  number. 

The  Coast  Guard  District  in  which  the  case 
occurred . 

(4)  OCCUR 

>0 

r 

The  date  and  time  the  case  entered  the  system. 
(In  decimal  days)  For  example,  26.0156 
represents  a case  that  occurred  on  the  27th 
day  of  the  simulation  at  approximately  00:23. 

(SIMSCRIPT  starts  with  Day  = 0) . 

(5)  BOX 

1 < BOX  < 

- - ! 

There  are  a total  of  eight  categories  rela- 
tive to  the  day,  time,  and  season,  the 

case  entered  the  system.  These  include 

Weekend/Peak/ Day (3) ; Weekend/Peak/Night (4) ; 

| 

; 

' 

0 

Weekend/Non -Peak/Day (7) ; Weekend/Non-Peak/Night (8) ; 
Weekday /Peak/Day (1) ; Weekday/Peak/Night (2) ; 
Weekday/Non -Peak/Day (5) ; Weekday /Non-Peak/ 

Night (6) . 

Indicates  that  the  exogeneous  event  tape 
(input  to  OPSIM)  prepared  in  PREPRO  was 
created  using  the  historical  times  of  occurrence. 

(6)  FPRI 

1 < FPRI  ^ 5 

The  first  priority  of  the  case;  i.e.,  when  it 
entered  the  system,  (The  case’s  priority  is 
updated  during  the  service  of  case  and  the 

; 

final  priority  value  retained  in  PRI.) 
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CASE  PARAMETER 

(7)  MNM 

(8)  NNN 

(9)  GAMMA 

(10)  NEEDO 


(11)  AIR 

(12)  OFSHR 


VALUE  EXPLANATION 


0 < MMM  < 2 


> 0 

0.00  < 
GAMMA  < 
0.99" 

0.00 

< NEEDO  < ic 


< AIR  < 99 

< OFSHR  < 

999 


.25 


.35 

3.0 

0.95 

0 


Number  of  resources  required  to  tow  or 
escort  the  client. 

Number  of  needs  other  than  search  or  tow. 
The  degree  of  non-parallel  service  of 
a multi  resource  case. 

For  single  resource  cases 
Identification  of  the  need  for  a single 
resource  case. 

Implies  the  case  could  be  a multi  resource 
or  a pure  search  case.  (If  NEED1  through 
NEED5  have  a value  greater  than  zero, 
then  this  is  a multi -resource  case.  If 
SIS  is  greater  than  zero,  then  the  case  is 
search  case.) 

Air  temperature  °F. 

Distance  in  nautical  miles,  off  shore  where 
case  occurred 

Within  the  simulation,  hand-off  tows  occur 
at  a 1/4  mile  offshore.  Thie  value  is  up- 
dated from  original  input  value  of  OFSHR. 
Position  over  a 1/2  mile  off  shore 
Position  over  a 1/2  mile  but  less  than  10 
miles  off  shore,  (open  waters) 

999  miles  or  more, 
on  shore 
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CASE  PARAMETER 


VALUE 


EXPLANATION 


(13)  VIS 

0 < ATS  < 99 

Visibility  (in  miles) 

99 

If  not  known  NX;  not  applicable,  NA, 

or  blank. 

(14)  WIND 

0 < WIND  < 99 

Wind  Force  in  knots 

1 

If  NX;  NA  or  Blank 

(15)  SWELL 

0 < SWELL  < 99 

Sea  Height  in  full 

1 

if  NX;  NA  or  Blank 

(16)  L 

0 < L < 201 

Length  of  Client  in  feet  if  client  is 

a boat 

0 

Client  is  an  aircraft  or  some  other 

classification 

66 

If  client  is  over  65  feet  but  less  than 

or  equal  to  100  feet. 

101 

If  client  is  over  100  feet  but  less  than 

or  equal  to  200  feet 

201 

If  client  is  over  200  feet 

(17)  POB 

0 < POB  < 4095 

■ 

People  on  board 

4095 

l 

If  greater  than  4095 

(18)  SIS 

0 

No  long  search  required 

1 0 < SIS  < 10 

I 

■ 

Number  of  search  resources  on  a long  sear 

case  is  input  to  OPSIM.  Each  time  a re- 
source completes  its  assigned  search  miles, 
SIS  is  reduced  by  1.  Therefore,  in  this 
mode,  SIS  can  be  the  remaining  number  of 
resources  required  to  fulfill  the  long 
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CASE  PARAMETER 


VALUE 


EXPLANATION 


(19)  S2S 


(20)  TSM 


(21)  OSTO 


(22)  UTYPE 


(23)  VALUE 


(24)  XCX 


-2  < S2S  < 2 


>0 


>0 


>0 


search  needs  of  the  case.  Once  the 
long  need  is  fulfilled,  SIS  is  set  to 
this  value.  The  number  of  search  re- 
sources (up  to  five)  can  be  found  by 

| examining  the  values  of  RESA6  through 

i 

jRESAlO.  When  positive,  it  indicates 
' a resource  searched  for  the  client. 

1 S2S  is  the  code  input  for  each  case 

d 

!]  describing  the  requirement  for  short 


■ search.  It  is  ’updated  at  the  completion 

; of  the  short  search  by  negating  the  code. 

I 

■ 0 = no  short  search;  -2  = short  search  by 

; 

f additional  resource.;  -1  = short  search 

! by  first  resource  to  scene. 

! 

TSM  represents  the  total  number  of  search 
miles,  applied  to  either  long  or  short 
search. 

The  on  scene  time  for  a single  need  case. 
See  NEEDO. 

Describes  the  type  of  client,  either 
aircraft  or  surface  vessed. 

0 < VALUE  < 130003|  Value  of  the  vessel  in  distress. 

Value  of  the  vessel  exceeds  $130,000. 
Original  X coordinate  case  location  in 
nautical  miles . 
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130001 

XLOW  < XCX  < XLMT 


CASE  PARAMETER 


VALUE 


EXPLANATION 


(25)  YCY 

(26)  XC 

(27)  YC 

(2  8)  STAIN  I 

I 

(29) CNRES 

(30) RESAO 

j 

(31)  PRI  j 


XPT 


YLOW  < YCY  < YLMT 


ATT 


any  signed  value 


any  signed  value 
>0 

>0 

>0 

0 

>0 


Cases  with  no  location  data  at  undefined 
OPFACs  are  assigned  this  value  for  XCX 
from  the  district  origin. 

Cases  whose  location  fall  outside  district 
limits  (non  C-130) . 

Original  Y coordinate 

Cases  with  no  location  data  at  undefined 
OPFACs  are  assigned  this  value  for  YCY. 

Cases  whose  location  fall  outside  district 
limits  (non  C-130) 

Updated  X coordinate  case  location.  This 
value  is  updated  when  the  client  moves 
during  service,  such  as  escort  or  tow, 
and  must  be  updated  either  for  interrupt, 
hand-off  or  completion. 

Similar  to  XC. 

The  primary  station  of  the  case,  as  calcu- 
lated in  OPSIM. 

The  total  number  of  resources  that  re- 
sponded to  the  case. 

The  resource  responding  to  the  need  of  a 

case,  for  a single  resource  case. 

If  the  case  is  a multi -need  case,  this 

value  is  zero . See  NEEDO  and  OSTO . 

The  updated  priority  of  the  case.  The  case’s 

priority  can  change  during  the  course  of 
service . See  FPRI . 


CASE  PARAMETER 
(32)  REA 


VALUE 

>0 


(33)  COST 


>0 


(34)  ITOL 


>0 


0 

1 

2 


3 

4 

5 


EXPLANATION 

First  Reason  the  case  was  put  into  the  queue. 

See  OPSIM  definitions.  Part  II,  Section  II 
of  OPSIM  documentation. 

0 = case  interrupted  2 = case  never  goes 

into  a queue 

1 = no  available 

resources 

The  cost  of  serving  a case.  Regardless  of  the 
cost  option  this  value  is  calculated  as  the 
accumulated  cost  of  vectoring  to  scene,  and 
if  required, searching  for  the  client. 

The  on  scene  time  for  serving  needs  other 
than  search  is  not  included  in  this  calculation. 
For  cases  completed  or  in  the  system  at  the 
end  of  OPSIM;  the  values  of  interest  include: 
Case  not  served  within  tolerance 
Case  “^i^t^served  within  tolerance 
No  resource  has  yet  arrived  on  scene. 

For  cases  which  are  exceptions,  the  values 
of  interest  include: 

No  capable  resource  types  in  system 
No  capable  resource  types  at  the  primary  and 
adj acents 

No  capable  resource  available  to  serve 
an  air  escort  case  when  requested. 
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CASE  PARAMETER  VALUE 


EXPLANATION 


(35)  NOIIff 


(36)  NQUE 


(37)  TINT 


(38)  TQUE 


(39)  TQUE1 


(40)  TSVC 


(41)  TWAIT 


>0 


>0 


The  case  has  an  unacceptable  set  cf  input 
parameters . 

Each  time  a case’s  service  is  interrupted,  this 
value  is  updated.  Total  number  of  times  a 
case  is  interrupted. 

Each  time  a case  is  queued,  this  value  is 

j 

updated.  Recall  a case  can  be  queued  if 
i interrupted  and/or  if  no  resource  is  available 
at  that  time  to  serve  the  case,  i.e.  the  case 

s 

waits.  Total  number  of  times  a case  is  queued. 
>0  When  a case  is  interrupted,  the  total  time 
spent  in  this  status  is  recorded. 

>0  j When  a case  is  queued,  the  total  time  it 
: spends  queued  is  recorded. 

>0  ’ The  elapsed  time  the  case  spends  in  the  queue 

prior  to  the  first  resource  arriving  to  the 


scene . 


>0  The  total  elapsed  time  the  case  spends  in 


the  system. 

>0  The  time  elapsing  between  the  case  arrival  to 

the  system  and  the  first  resource  arriving 

l 

on  scene  or  to  the  expected  location  of 
the  client. 
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CASE  PARAMETER  ' VALUE 

(42)  NEED1  >0 

(43)  OST1  >0 


(44)  DELTA! 


0 5 


DELTA1 
< 0.99 


EXPLANATION 

For  multi  resource  cases  this  is  the  first  need 
of  the  case. 

For  multi  resource  cases,  this  is  the  time  spent 
on  scene  serving  NEED1.  This  value  for 
pure  search,  tow  or  escort  cases  will  be 
zero.  It  is  also  possible  that  this  value  be 
zero  for  cases  where  the  resource  is  called  to 
scene  and  renders  no  assistance  nor  expends 
any  time  on  scene,  i.e.  returns  home  immediately. 
For  multi -resourced  cases,  this  is  the  frac- 
tion of  time  into  the  case,  the  resource  is 
to  arrive  on  scene,  and  expend  the  associated 


0ST1 . 


(45)  RESA1  > 0 

C46)  NEED2  > 0 


(47)  OST2 

(48)  DELTA 


(49)  RESA2 

(50)  NEED3 


> 0 
0 < 

DELTA2 
< .99 
> 0 


For  multi-resource  cases,  this  is  the  re- 
source assigned  to  the  case  to  serve  NEED1. 

For  multi  - resource  cases,  this  is  the  second 
need  of  the  case.  If  the  case  requires  two 
tow  or  escort  resources , the  second  tow  resource 
is  recorded  in  RESA  2,  but  NEED2  will  be  zero. 
See  OST1 . (Replace  OST1  with  OST2) 

See  DELTA1 


See  RESA1. 
See  NEED1. 
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CASE  PARAMETER  VALUE 


EXPLANATION 


(51)  OST  3 

(52)  DELTA3 

(53)  RESA3 

(54)  NEEP4 

(55)  OST4 

(56)  DELTA4 

(57)  RESA4 

(58)  NEED5 

(59)  OST5 

(60)  DELTA5 

(61)  RESA5 

(62)  RESA6 

(63)  RESA7 

(64)  RESA8 

(65)  RESA9 

(66)  RESA10 
(66)  SEQNO 


> 0 
> 0 
> 0 
> 0 
> 0 
> 0 


See  OST  1. 

See  DELTA  1. 
See  RESA  1. 

$ 

See  NEED  1. 

See  OST  1. 

See  DELTA  1. 

{ See  RESA  1 . | 

! i 

See  NEED  1. 

t 

See  OST  1. 

See  DELTA  1.  I 
See  RESA  1. 


Note  that  this 
information  is  kept 
for  the  first  five 
resources  assigned 
to  the  needs  and  tow 
portion  of  the  case. 


j 


The  first  five  resources  assigned  to  each 
>of  the  first  five  SM(i)  's  of  a long 
search  case  are  recorded  in  these  attributes 

The  sequence  number  of  the  case  facilitates 
the  cross  referencing  of  parameters  in 
the  Quick  Query  Output.  It  also  gives 
the  order  in  which  cases  are  completed. 
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